package com.qiangesoft.blog.core.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.qiangesoft.blog.core.entity.BlogArticle;
import com.qiangesoft.blog.core.pojo.dto.ArticleDTO;
import com.qiangesoft.blog.core.pojo.query.ArticleQueryDTO;
import com.qiangesoft.blog.core.pojo.vo.*;
import org.apache.ibatis.annotations.Param;

import java.util.List;
import java.util.Map;

/**
 * <p>
 * 博客文章 Mapper 接口
 * </p>
 *
 * @author qiange
 * @since 2023-06-05
 */
public interface BlogArticleMapper extends BaseMapper<BlogArticle> {

    /**
     * 后台分页获取文章
     *
     * @param page 分页对象
     * @param map  参数map
     * @return
     */
    Page<ArticleListVO> selectArticle(@Param("page") Page<Object> page, @Param("param") ArticleQueryDTO articleQuery);

    /**
     * 后台根据主键获取文章详情
     *
     * @param id 主键id
     * @return
     */
    ArticleDTO selectPrimaryKey(Long id);

    /**
     * 置顶文章
     *
     * @param article 文章对象
     */
    void putTopArticle(@Param("article") ArticleDTO article);

    /**
     * 发布或下架文章
     *
     * @param article 文章对象
     */
    void publishAndShelf(@Param("article") ArticleDTO article);

    /**
     * 文章贡献度
     *
     * @param lastTime 开始时间
     * @param nowTime  结束时间
     * @return
     */
    List<ContributeVO> contribute(@Param("lastTime") String lastTime, @Param("nowTime") String nowTime);

    /**
     * 首页获取推荐文章
     *
     * @param articleId 文章id
     * @return
     */
    List<LatestArticleVO> listRecommendArticles(@Param("articleId") Long articleId);

    /**
     * 首页获取下一篇或上一篇文章
     *
     * @param id      文章id
     * @param type    类别
     * @param publish 发布状态
     * @return
     */
    LatestArticleVO getNextOrLastArticle(@Param("id") Long id, @Param("type") Integer type, @Param("publish") Boolean publish);

    /**
     * 首页获取最新文章
     *
     * @param id      文章id
     * @param publish 发布状态
     * @return
     */
    List<LatestArticleVO> getNewArticles(@Param("id") Long id, @Param("publish") Boolean publish);

    /**
     * 首页根据主键获取文章详情
     *
     * @param id 文章id
     * @return
     */
    ArticleInfoVO selectPrimaryKeyById(@Param("id") Long id);

    /**
     * 首页分页获取文章
     *
     * @param page       分页对象
     * @param publish    发布状态
     * @param categoryId 分类id
     * @param tagId      标签id
     * @return
     */
    Page<ArticlePreviewVO> selectPreviewPage(@Param("page") Page<Object> page, @Param("publish") Boolean publish,
                                             @Param("categoryId") Long categoryId, @Param("tagId") Long tagId);

    /**
     * 首页热门文章
     *
     * @param publish 发布状态
     * @param limit   条数
     * @return
     */
    List<ArticlePreviewVO> selectHotArticle(@Param("publish") Boolean publish, @Param("limit") Integer limit);

    /**
     * 首页分页获取归档
     *
     * @param page    分页对象
     * @param publish 发布状态
     * @return
     */
    Page<ArticlePreviewVO> selectArchivePage(@Param("page") Page<Object> page, @Param("publish") Boolean publish);
}
